home *** CD-ROM | disk | FTP | other *** search
/ Aminet 28 / Aminet 28 (1998)(GTI - Schatztruhe)[!][Dec 1998].iso / Aminet / util / moni / StackWatch.lha / StackWatch / StackWatch.doc < prev    next >
Encoding:
Text File  |  1998-10-21  |  2.6 KB  |  83 lines
  1.  
  2.                                 StackWatch v1.1
  3.                                 ---------------
  4.  
  5.                             © 1998 Daniel Kasmeroglu
  6.                             ------------------------
  7.  
  8.                         Based on StackMon by David Kinder
  9.                         ---------------------------------
  10.  
  11. Introduction
  12. ------------
  13. StackWatch is an utility which monitors the stack usage of a task. It
  14. helps you to find out whether a task has got enough stack or not. You
  15. can set the stacksize via "Icon/Information" for icons or via the command
  16. "stack" in the shell. With this tool you can find out if a program fails
  17. because it don't have enough stack.
  18.  
  19.  
  20. Features
  21. --------
  22.  
  23.   - completely fontsensitive while using "bgui.library"
  24.   - is a commodity
  25.   - localised (currently only the german catalog available)
  26.   - saves the maximum used in an entry (StackMon doesn't recognize this value)
  27.   - during a list refresh only new tasks will be replaced or closed tasks
  28.     will be removed
  29.  
  30.  
  31. Use
  32. ---
  33.  
  34. StackWatch requires AmigaOS 2.04 or higher and the "bgui.library" v37.
  35. The "locale.library" is also helpful. You can start it by a doubleclick
  36. on its icon or running it from the shell. Another way is to put the program
  37. in the WBStartup drawer so it will be started automatically.
  38. If the window of StackWatch is opened you will get a list of all tasks.
  39. Simply click on an entry and you will get all informations about it's
  40. stack usage. Monitoring is only active when the window is active.
  41. The program stops monitoring when the task was shutted down.
  42. Also you will get a message "Stack Overflow" if a program uses more
  43. stack than it has. You should notice that the system may crash in this
  44. case.
  45.  
  46.     CLI-USAGE:
  47.  
  48.       CX_POPUP/S      : if set the window will be opened at start
  49.       CX_POPKEY       : set the hotkey (default: alt s)
  50.       PS=PUBSCREEN/K  : set the name of the pubscreen to run on (default: Workbench)
  51.  
  52.     ToolTypes:
  53.  
  54.       CX_POPUP=YES|NO : see above
  55.       CX_POPKEY=xxx   : see above
  56.       PUBSCREEN=xxx   : see above
  57.  
  58.  
  59. Compiler
  60. --------
  61.  
  62. StackWatch was written using Amiga E v3.3a. Note that E programs have their
  63. own stack managememt system, so StackWatch is only useful with these programs
  64. if you are using the included module "setstack()". You must call "setstack()"
  65. at the begin of your program and the displayed data will be correct.
  66. The sources of this program are included. The use of the call "setstack()"
  67. is demonstrated in these sources (it's very, very, very, very simple ).
  68.  
  69.  
  70. Address
  71. -------
  72.  
  73. Send bug reports, comments, etc. to:
  74.  
  75. InterNet Email (prefered): raptor@cs.tu-berlin.de
  76.  
  77.  
  78. Greetings
  79. ---------
  80.  
  81.   Andrija Antonijeviá   - Thanks for serbian translation !
  82.  
  83.